home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / pcbdbase.zip / PCBDBASE.DOC < prev    next >
Text File  |  1991-07-29  |  16KB  |  325 lines
  1.                       PCBDBASE 'PCBoard USERS DataBase'
  2.  
  3.                                 Version 1.0
  4.                                by Barry Young
  5.                              System Support BBS
  6.                           PCBoard 3-node vrs 14.5a
  7.                            Westminster, Colorado
  8.                                (303)-469-9359
  9.                                   07/30/91
  10.  
  11.  
  12.         Thank you for downloading this program! This program was originally
  13. designed  for  my personal use  to help me  in searching various statistics
  14. about the callers on my board. The PCBSM program that comes with PCBoard is
  15. a very good  User Maintenance program, but when wanting to search for  info
  16. on more  than one user, or  on more than one particular user field, I would
  17. have  to run multiple searches. There are some other  Shareware/PD packages
  18. out there that were of use, but none that I had found, would do my multiple
  19. searches, or was too complicated to use easily.
  20.  
  21.         I  originally intended  on writing a simple program, but had gotten
  22. carried  away  with it. There  may  be  more enhancements/features  to this
  23. DataBase  program  as time  goes by, whether  from  my  own ideas, or  from
  24. feedback from fellow sysops that have tried this package out.
  25.  
  26.         As  you  read this  manual, you  will find  that I, as  many others,
  27. am  not fond  of creating documentation, and  prefer  to  get  to the point.
  28. I  will try  to make the setup and procedures  to this package as easily as
  29. possible so that you can get it going and experiment with it.
  30.  
  31. The files included in this ZIP'ped package are:
  32.  
  33. PCBDBASE.EXE  (main program)
  34. PCBDBASE.HLP  (help file on the various variables for searching)
  35. PCBDBASE.DOC  (the manual that you are presently reading)
  36. PCBDBASE.CFG  (sample configuration file, although not required)
  37. BBSAD         (my BBS advertisement and logon screen)
  38. PCBDBASE.OUT  (sample output from database run)
  39.  
  40. This  is a ShareWare package. I  currently have four other PCBoard utilities
  41. available, in  which  are Public Domain packages. The non-registered version
  42. (provided  for being passed  around the  BBS  world) has  three differences.
  43. One being the heading of the output (screen or printout). The non-registered
  44. version will state 'NON-REGISTERED' whereas the registered version will list
  45. your  BBS Name. The  second one being the registered version will store your
  46. Input variables  and options  in the configuration file (.CFG)  after it has
  47. completed the run. This will save time in having to re-input your selections
  48. each time  you  run the program. This  is also quite handy if you select the
  49. program to create a File output (instead of screen or printout) in which you
  50. can  copy  the output file  to be listed  as  one of your BBS Bulletins. The
  51. third feature of the registered version allows you to re-run the program
  52. without having to reload it from the DOS prompt, in case you want to check
  53. on more than one outputted result. When you register this package with me, I
  54. will  mail  you the latest version  of the program and the .KEY file.
  55.  
  56. Files being accessed from this package:
  57.  
  58. The only two files required to run this program are the PCBDBASE.EXE and the
  59. PCBDBASE.HLP files. They  can be stored in any subdirectory, although I keep
  60. mine in my \PCB directory. They, in turn, will create two sort files, called
  61. SORTTEMP and SORTOUT. The two sort files can be deleted upon completion, but
  62. I  just leave them alone. The  next time  you  run the program, they will be
  63. replaced with the latest execution. If  you want provided  defaults  for the
  64. program, you  can create  a PCBDBASE.CFG  (configuration file)  that will be
  65. read in  by the program  (if found in the same directory as the program is).
  66. The  program  will then allow you to hit the <ENTER> to accept the defaults,
  67. or allow you to over-ride them with your new Input variables. The registered
  68. version  will store  your new inputs  for your next run. This  will save you
  69. from having to re-input the Input variables each time.
  70. The PCBoard USERS file  will be accessed (read (share) only mode)  to search
  71. for your selections. It will NOT be written to or modified in any fashion.
  72. In the future, I may provide an option to update the USER records  depending
  73. upon your selections.
  74. If  you select to create  a File Output option, it will create a file called
  75. PCBDBASE.OUT  in the same directory as the program. This  file can be viewed
  76. or printed or copied to one of your BLT (bulletin) files to be viewed  while
  77. online your BBS. I  currently  use the program  to find users that have gone
  78. over  the File Upload/Download Ratio  and create a bulletin for me in my own
  79. private conference.
  80.  
  81. ____________________________________________________________________
  82. PCBDBASE.CFG  File Layout:
  83.  
  84.  0                    <1> <Automatic/Manual mode>
  85. D:\PCB\MAIN\USERS     <2> <USERS drive:\path\filename location>
  86. ACCLVL                <3> <1 of 3 Variable selections>
  87. <                     <4> <1 of 3 Variable criteria>
  88. 10                    <5> <1 of 3 Variable searches>
  89. FDN/FUP               <6> <2 of 3 Variable selections>
  90. >                     <7> <2 of 3 Variable criteria>
  91. 19                    <8> <2 of 3 Variable searches>
  92. LDATE                 <9> <3 of 3 Variable selections>
  93. <                    <10> <3 of 3 Variable criteria>
  94. 040191               <11> <3 of 3 Variable searches>
  95. A                    <12> <AND OR option if two Variables>
  96. A                    <13> <AND OR option if three Variables>
  97. ACCLVL               <14> <1 of 6 Output Variables>
  98. FDN/FUP              <15> <2 of 6 Output Variables>
  99. LDATE                <16> <3 of 6 Output Variables>
  100. NAME                 <17> <4 of 6 Output Variables>
  101. FILESDN              <18> <5 of 6 Output Variables>
  102. FILESUP              <19> <6 of 6 Output Variables>
  103. N                    <20> <Re-Run program after? (Yes or No)
  104. F                    <21> <Output results:Screen,File,Printer>
  105. ____________________________________________________________________
  106.  
  107. If you not require all three sets of Variable selections, then  just
  108. blank out the field records in the .CFG file. This also goes for the
  109. AND/OR  records, and  same  for the  Output Variables. In  the above
  110. example .CFG file, I am using every option.
  111.  
  112. The 1st record is normally set to 0. If it has a 1, the program will
  113. automatically  run the program and exit back to DOS. It will not ask
  114. for any input options. This would be useful for SysOps that want the
  115. program  to create a Bulletin file  during their daily Event without
  116. requiring operator input. If there was a 0 there, the program  would
  117. be waiting for the operator.
  118. You will need to use your own editor to change this variable.
  119.  
  120. If you wanted to run this program more than once, using different
  121. variables, for more than one Bulletin file, the following is an
  122. example of the procedure:
  123.  
  124. CD\PCB
  125. COPY PCBDBASE.CF1 PCBDBASE.CFG
  126. PCBDBASE
  127. COPY PCBDBASE.OUT \PCB\GEN\BLT10
  128. COPY PCBDBASE.CF2 PCBDBASE.CFG
  129. PCBDBASE
  130. COPY PCBDBASE.OUT \PCB\GEN\BLT11
  131.  
  132. This assumes  that you had created two .CFG files, one being labeled
  133. PCBDBASE.CF1  and  another  PCBDBASE.CF2. It  also  assumes that you
  134. wanted to have two bulletins available for online viewing. One being
  135. BLT10 (bulletin #10) and BLT11 (bulletin #11).
  136.  
  137. The 2nd record  is  the  location  of the  BBS USERS file, including
  138. drive, subdirectory, and filename.
  139.  
  140. The 3rd thru 11th records are to tell the program what to search for.
  141. You are  only required to have 1 of 3 Search Variables. In the above
  142. configuration file, I had elected to search for 3 variables:
  143. ACCLVL
  144. FDN/FUP
  145. LDATE
  146. Each variable  will  require a criteria condition. In the above case,
  147. the program  will only  look for users that have an Access Level less
  148. than  10  on the 1st variable. Each  variable  also  requires what to
  149. search for, based on the Variable and Condition. In  this case, I was
  150. only  looking  for Users that had an  access level  less than 10, AND
  151. that their  Files Downloaded to Files Uploaded ratio  was  worse than
  152. 19/1  AND  that they hadn't been online  (LAST-TIME-ON) since  before
  153. 04/01/91.
  154.  
  155. The 12th and 13th variables will only be required if you are searching
  156. for  more  than one Variable. There  are two conditions: AND or OR. In
  157. the above options, I wanted to search for:
  158. ACCLVL < 10
  159.    AND
  160. FDN/FUP > 19
  161.    AND
  162. LDATE < 040191
  163.  
  164. If I had used the OR condition, the program would have searched for any
  165. one of the 3 selections. Another example:
  166. ACCLVL < 10
  167.   AND
  168. FDN/FUP > 19
  169.   OR
  170. LDATE < 040191
  171.  
  172. That  would  have  found anyone with (  ACCLVL < 10  AND  FDN/FUP > 19)
  173. OR   anyone  that  had  not  been  online  (LDATE) since before 040191.
  174.  
  175. The 14th thru 19th variables  are  for the output report. You  can have
  176. up to 6 variables  being reported upon. You  are only  required to have
  177. one variable. The  program  will  sort  the  output  based upon the 1st
  178. variable. In  the above example, I wanted  the report to  be  sorted by
  179. ACCLVL.
  180.  
  181. The 20th option  is only valid to registered versions. If  it is set to
  182. Y (yes),the program will re-run after completion (keeping your previous
  183. Input selections). If N (no), it will return back to DOS.
  184.  
  185. The 21st (last option) is used for your output. (S) for screen display,
  186. (F) for file output (PCBDBASE.OUT will be the name), or (P) for printer
  187. output.
  188.  
  189. If you elected for the File output, you could then COPY the PCBDBASE.OUT
  190. file  to one  of your BLTxx (bulletins) to be displayed while online the
  191. BBS.
  192.  
  193. The PCBDBASE.CFG file is NOT required. If found, the program will use its
  194. options  within the program for Defaults, in which can be manually over-
  195. written by you.
  196.  
  197. Provided is a sample PCBDBASE.OUT output file from the above conditions:
  198.  
  199.   PCBoard 14.5  USERS  DATABASE  Registered to System Support BBS
  200.   by Barry Young │ System Support BBS  Version    1.0ß  07/28/91
  201.   Latest Updates available  at  (303)-469-9359   Westminster, CO
  202.  
  203. ───────────────────────────────────────────────────────────────────────────────
  204. The following conditions were met as of  07-29-1991  10:27:02
  205. ACCLVL     (less than)       10
  206.                 AND
  207. FDN/FUP    (greater than)    19
  208.                 AND
  209. LDATE      (less than)       040191
  210. ───────────────────────────────────────────────────────────────────────────────
  211. ACCLVL  FDN/FUP  LDATE     NAME                       FILESDN  FILESUP  
  212. ═══════════════════════════════════════════════════════════════════════════════
  213.      9   20      01/15/91  name removed                    20
  214.      9   20      03/06/91  name removed                    20
  215.      9   21      03/08/91  name removed                    43        2
  216. ───────────────────────────────────────────────────────────────────────────────
  217.       3  of      663 Records found.
  218.  
  219. While you are selecting your Input Variables, you can type in a question mark
  220. in front of the variable to get a simple explanation about the variable.
  221.  
  222. If  you  do  not want all three variables to be searched upon, you can bypass
  223. the rest by typing in a  B  (bypass remaining).
  224.  
  225. In most cases, you can type in  END to abort the program.
  226.  
  227. To run the program, change to the drive:\directory in  where  you have placed
  228. the PCBDBASE.EXE and PCBDBASE.HLP file, and type in PCBDBASE <ENTER>.
  229. It will 1st ask you of the location of the USERS file, and then the variables.
  230.  
  231. For your own protection, in case  you  elect to create bulletins from this, I
  232. have excluded the 1st USER record (yours) from  being displayed at all times.
  233.  
  234. I can be reached on my BBS in Colorado:
  235.  
  236. System Support BBS
  237. Barry Young
  238. Westminster , CO
  239. (303)-469-9359   (PUBLIC line with USR HST 14.4 v.42bis)
  240. (303)-469-9389   (MEMBERS ONLY line with USR HST DS 14.4 v.32 v.42bis)
  241.  
  242. I also echo-mail both the SMARTNET and METRONET systems. Leave me a message
  243. in the SMARTNET 'SysOp' or 'SmartNet' conference. I presently only carry  a
  244. handful  of  MetroNet  conferences, so  most  likely the  KMAIL or PCBHINTS
  245. conference  would  get  my attention. Neither of those really pertain to my
  246. program, but I read both of those conferences.
  247.  
  248. If you like this program, and continue to use it, you are required to
  249. register this program for continued usage. My other 4 BBS utilities are
  250. Public Domain and can be used and continued by anyone. I feel this program
  251. to be of more value to the SysOp and that is why it was made ShareWare.
  252. Without registrations, I will be more inclined in not producing more
  253. features for anyone besides myself in future updates.
  254.  
  255. If you have any problems, complaints, suggestions for improvements,
  256. PLEASE, feel free to pass them along to me.
  257.  
  258. If you want to register this program, please include $15 made out to
  259. BARRY YOUNG
  260.  
  261. Mail the registration check and a simple form to me at:
  262.  
  263. E.K. Williams & Company
  264. C/O Barry Young
  265. 8774 Yates Drive Suite 210
  266. Westminster, Colorado
  267. 80030
  268.  
  269. Upon receipt, I will mail you the latest version of PCBDBASE on a
  270. 360 kb formatted disk along with the encrypted .KEY file. You will
  271. also be entitled to a one-year membership to my BBS. The normal
  272. Contribution is $10 or $20 a year, each rate gives more access.
  273. This includes having access to either the Public Node or the
  274. Members Node. Both are HST 14.4 9600 baud modems locked in at
  275. 19,200, with the Members Node being a Dual Standard for v.32
  276. connections by other non-USR v.32 9600 modems.
  277.  
  278. ALSO, please  include what your User Name and Password, along with
  279. your CITY/STATE  and Phone #'s. I will add you to the BBS files as
  280. well as mailing out your registered copy of the program.
  281. And ESPECIALLY include the name of your BBS to be displayed on the
  282. top line of the  output. This must be 30 characters or less to fit
  283. on the output.
  284.  
  285. NAME :_________________________________ (1st and last, no handles)
  286. STREET     :______________________________________
  287. CITY/STATE :______________________________________
  288. ZIP CODE   :______________
  289. PHONE #(s) :______________________________________
  290. PASSWORD   :___________________
  291. BBS NAME   :__________________________________   (30 char's or less)
  292.  
  293.  
  294. Besides the PCBDBASE package, I also have available the 4 Public
  295. Domain utilities:
  296.  
  297. PCBCITY.ZIP     35550  05-01-91  PCBoard 14.5 Utility to Display Out of State
  298.                                | Callers. You define what States are to be
  299.                                | excluded from the display.
  300.                                | This can be redirected to a file to be used
  301.                                | as a bulletin on your system.
  302.  
  303. PCBCPS.ZIP      66936  04-20-91  Utility to DISPLAY File Transfer Information
  304.                                | This will create a graph that displays the
  305.                                | various Baud-rate, CPS, and Protocols used.
  306.                                | You can use it to display the graph to your
  307.                                | screen, or use it to be redirected to a
  308.                                | bulletin. Multi-Node capable (file-sharing)
  309.  
  310. PCBDIRSD.ZIP    36988  05-05-91  DISPLAY  PCBoard's DIRectories  Statistics
  311.                                | This will create a graph that displays the
  312.                                | total number of bytes used  and number  of
  313.                                | files used within each of your  DIR files.
  314.                                | You can use it to display the graph to your
  315.                                | screen, or use it to be redirected to a
  316.                                | bulletin. Multi-Node capable (file-sharing)
  317.  
  318. PCBDRST1.ZIP    39458  05-27-91  PCBoard Utility  to  DISPLAY DOOR Statistics
  319.                                | This will create  a graph  that displays the
  320.                                | Door usages of all  or  selected doors used.
  321.                                | You  can use it to display the graph to your
  322.                                | screen,  or  use  it  to  be redirected to a
  323.                                | bulletin. Multi-Node  capable (file-sharing)
  324.  
  325.